TSpinDblEdit and TDBSpinDblEdit Version 1.5e (c) copyright 1996-97 W. Braun All Rights Reserved Delphi 1-3 / C++Builder VCL-Components Dear developer and user, with these components you can cover all numerical entryfields in your application and so you achieve an uniform formatted outward shape of your application. I hope these components will help you with your work and make it a little bit easier. Content 1. Installation 2. New 3. Properties 4. Description 5. Registration 6. Glossary 7. Warranty 8. Shareware 1. Installation I. Delphi 1-2 Please use for Delphi 1.x "D_16.ZIP" and for Delphi 2.x "D_32_2.ZIP". 1. Copy the files DEdSpin.DCU (DEdSpin.DCR, DEdSpin.RES, Calc.DCU and Calc.DFM into any subdirectory; e.g. C:\DELPHI\Z_COMP 2. Choose Options | Install Components 3. Click Add 4. Type the name of directory where you placed the component followed by DEDSPIN.DCU, e.g. C:\DELPHI\Z_COMP\DEDSPIN.DCU 5. Click OK 6. Click OK II. Delphi 3 Please use "D_32_3.ZIP" file 1. Copy the files DEdSpin.DCU (DEdSpin.DCR, DEdSpin.RES, Calc.DCU and Calc.DFM into any subdirectory; e.g. C:\DELPHI\Z_COMP 2. Choose Components | Install Components 3. Select your favorited package ( default dclusr30.dpk) and click Add. 4. Type the name of directory where you placed the component followed by DEDSPIN.DCU, e.g. C:\DELPHI\Z_COMP\DEDSPIN.DCU or click browse to find the unit DEDSPIN.DCU 5. Click Compile 6. Follow until message 'TSpinDblEdit and TDBSpinDblEdit have been registered' 7. Save package III. C++ Builder Please use "D_CB.ZIP" file 1. Copy the files DEdSpin.OBJ, DEDPSIN.HPP, DEdSpin.DCR, DEdSpin.RES, Calc.OBJ, Calc.HPP and Calc.DFM into any subdirectory; e.g. C:\CBUILDER\Z_COMP 2. Choose Options | Install Components 3. Click Add 4. Type the name of directory where you placed the component followed by DEDSPIN.OBJ, e.g. C:\CBUILDER\Z_COMP\DEDSPIN.OBJ 5. Click OK 6. Click OK In the new page on your component palette WB you will find TSpinDblEdit,TDBSpinDblEdit. Now you only have to click these components and afterwards you put then on your form at the right position. 2. New Version 1.5e ( 08/08/1997) -Key Alt+Down/Up opens the calculator (like ComboBox) suggestion from Thomas Grusche, 100027.231@compuserve.com -Property ActiveColor suggestion from G.Schmitthenner, Calcul-Schmitthenner@t-online.de -Property CalcColor -Bugfix for Ctl3D = False -inherited properties like BorderStyle now published into Delphi 2+3 too. Version 1.5d event OnCalClick event OnCalOpen event OnCalClose event OnSpinDownClick event OnSpinUpClick 3. Properties and events The following properties and events apply to both components TSpinDblEdit, TDBSpinDblEdit Properties : ActiveColor TColor, default clWindow Alignment default taRightJustify AutoCalculator boolean, pops the calculator OnEnter, default False CalcColor TColor, default clBackGround CalcDigitsNo Integer, different DigitsNo for Calculator, result will be rounded. Please set after DigitsNo. Calculator boolean, Calculatorbutton on/off, default off CalcHelpContext Integer, HelpContext for Calculator CalcPosition Position of Calculatorform, default posAbove [posAbove,posBelow,posLeft,posRight,posOnTop] DigitsNo Integer, Digitsnumber default 2, Min 0 , Max 10 Increment double, Increment for spin Info InfoMessageBox about this component MaxLength integer, MaxLength of number (incl. Decimalseparator), default 10, Max 30, Min 1 ( DigitsNo = 0 ) Normally calculated from Max-/MinValue MaxValue Double MinValue Double. If MinValue> = 0 and MaxValue<>MinValue then you can't entry negative number NegColor TColor, color negative Value NegFontColor TColor, fontcolor negative Value PosFontColor TColor, fontcolor positive Value Spin boolean, Spinbuttons on/off, default off If Spin is on use the Incrementvalue like TSpinEdit (standard Delphi component ) ThousSeparator boolean, Thousandseparator in Value, default True Value Double Events OnCalClick Calculator button click OnCalOpen Calculator open OnCalClose Calculator close OnSpinDownClick Down button click OnSpinUpClick Up button Click Additional the TDBSpinDblEdit have follows properties DataField NumericalField , Datatype ftSmallint, ftInteger, ftWord, ftFloat, ftCurrency DataSource DataSource for Table or Query Other Properties and Events inherited from TCustomEdit-class. 4. Description TSpinDblEdit serves for simplification of the entry and/or calculation of real or integer numbers. The standardly delivered tools from Borland are only useful for limited possibilities (look TMaskEdit). The entry of the numbers in TSpinDblEdit are adequate to a calculator : the position in front of a comma from the right to the left, the position witch follow the comma from the left to the right. With the entry of negative-symbol, the actuall number will be answered in the negative immediatly. The different to a calculator consists in the ability to edit and in the maximum quantity of the numbers before and after the decimal points, which are all given by the programmer. With a normal entry of numbers the positions before then comma will be filled up from the left and if the quantity of their maximum is achieved, it will be changed to the first position behind the comma. If you press the sign for decimal, the cursor jump automatically to the first position behind the comma. Alignment fixes the justify of the number in the entryfield: right(standard), centred or left. DigitsNo is the quantity of the digitnumbers. If no numbers are inserted, it will be filled up with zero ( e.g. 1.00 if DigitsNo = 2). Setting will be also update CalcDigitsNo. If the property ThousandSeparator are True, the ThousandSeparator-Signs will be inserted automatically and passed over by the cursor. NegColor and NegFontColor permit an otherwise-colored performance of the negative numbers to emphasize them optically. MinValue, MaxValue and MaxLength are the properties to fix the max. and min. values. These properties influence each over. Nonsensical properties will be catched extensively ( e.g. MinValue > MaxValue, MaxLength < Length(MaxValue)), etc.). Value is the topical number after the arrangment of the form. Spin gives you the possibility for an easy addition or substraction the topical entry with the number in the Increment-property by click the upsign(addition) or downsign(substraction). You can also use the keys up or down. Calculator places at your's employer a calculator. After pressing the symbol for the calculator a calculatorform will be anvanced, with this the applier can do calculations and afterwards then applier can overtake the result in the entryfield. The calculator is a nonmodalform without a frame. Calculatorform will be closed by : -Pressing the enterkey, result will be commit to entryfield -Klick on '<='-Button, result will be commit to entryfield -Pressing the escapekey or click outside of calendarform, result will not be commit. The additional properties of the TDBSpinDblEdit be useful for databaseconnection and they can use for display and/or manipulation the entries of the fields of the connected table or query. Datafield can be a type of integer or float fields. If the connected table or query is active during the fixing of the properties of TDBSpinDblEdit in the development environments ( that means : the properties of the connected fields are well-known ), the properties MaxValue, MinValue and DigitsNo will be automatically treated as equivalent to them of the connected field and they will not have to be worked on. Other Properties inherited unchanged from TCustomEdit-class. 5. Registration Registration Please read also the file order.txt -Notice : for C++ Builder please register only with Source-Code !!! Price for this components is -$15.00 (US) without Source -$30.00 (US) with Sourcecode ( > 2000 lines ). To order you can do this by following options : 1. CompuServe's Online Registration : GO SWREG TSpinDateEdit : -File-ID 14245 without Source -File-ID 14900 with Source TGermDateEdit : -File-ID 15615 without Source -File-ID 15616 with Source Update from TSpinDateEdit : -File-ID 15617 without Source Update from TSpinDateEdit : -File-ID 15618 with Source TSpinDblEdit : -File-ID 12832 without Source -File-ID 14901 with Source 2. Order by sending me an e-Mail. 3. Fill out and send the order form "order.txt" Registered users will receive any updates for the next year. The unregistered version can use with all functions, but only while the Delphi IDE is running. 6. Glossary If you have questions or suggestion, send me some lines by eMail or Fax. I'm thankfull for every good proposition. Yours, Wilhelm Braun eMail : 106216.1307@compuserve.com Fax : +49 0621 6296754 7. Warranty THIS SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OR MERCHANTABILITY. THESE COMPONENTS ARE PROVIDED WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES WHATSOEVER. BECAUSE OF THE DIVERSITY OF CONDITIONS AND HARDWARE UNDER WHICH THESE COMPONENTS MAY BE USED, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. THE USER IS ADVISED TO TEST THESE COMPONENTS THOROUGHLY BEFORE RELYING ON THEM. THE USER MUST ASSUME THE ENTIRE RISK OF USING THESE COMPONENTS. 8. Shareware THESE COMPONENTS ARE SHAREWARE. You may use the shareware version of these components for a 30 day trial period. If you would like to continue to use these components after the 30 day trial period, you are required to purchase the licensed version of these components.